home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / graphics / picfmts.doc < prev    next >
Text File  |  1995-04-22  |  43KB  |  1,090 lines
  1.                            ST Picture Formats
  2.                            ------------------
  3.                                Edited by:
  4.  
  5.                               David Baggett
  6.                          5640 Vantage Point Road
  7.                          Columbia, MD  21044 USA
  8.                              (301)  596-4779    
  9.  
  10.                                 Internet:
  11.                              dmb@wam.umd.edu 
  12.                                dmb@tis.com
  13.  
  14.                    (Please report errors or additions.)
  15.  
  16.         Copyright (C) 1988, 1989, 1990, 1991 by David M. Baggett
  17.  
  18.  
  19.     Non-profit redistribution of this document is permitted, provided
  20.     the document is not modified in any way.
  21.  
  22.     Reproduction of this document in whole or in part for  commercial
  23.     purposes is expressly forbidden without the prior written consent
  24.     of David M. Baggett.
  25.  
  26.     The  information  presented here is not guaranteed to be correct.
  27.     The editor and contributors will in no event be liable for direct,
  28.     indirect, incidental, or consequential damages resulting from the 
  29.     use of the information in this document.
  30.  
  31.     This document is the product of many hours of volunteer work by a
  32.     large number of people. Please respect this -- do not violate the
  33.     distribution policy.
  34.  
  35.  
  36.                               CONTRIBUTORS
  37.   
  38.     Steve Belczyk  Phil Blanchfield  Jason Blochowiak  John Brochu**
  39.         David Brooks  Daniel Deimert  Neil Forsyth  Stefan Hoehn  
  40.     Gerfried Klein  G. "Maddog" Knauss  Ken MacLeod  Shamus McBride
  41.          Jim McCabe  Lars Michael  Darek Mihocka  David Mumper
  42.            George Nassas  Jim Omura  George Seto  Joe Smith
  43.               Greg Wageman  Roland Waldi*  Gerry Wheeler
  44.  
  45.  
  46.                                 Contents 
  47.                                 --------
  48.  
  49.         NEOchrome                               *.NEO
  50.         NEOchrome Animation                     *.ANI
  51.         DEGAS                                   *.PI?   ? = 1, 2, 3
  52.         DEGAS Elite                             *.PI?   ? = 1, 2, 3
  53.         DEGAS Elite (Compressed)                *.PC?   ? = 1, 2, 3
  54.         Tiny                                    *.TN?   ? = 1, 2, 3, Y
  55.         Spectrum 512                            *.SPU
  56.         Spectrum 512 (Compressed)               *.SPC
  57.         Spectrum 512 (Smooshed)                 *.SPS
  58.         Art Director                            *.ART
  59.         C.O.L.R. Object Editor Mural            *.MUR
  60.         Doodle                                  *.DOO
  61.         Cyber Paint Sequence                    *.SEQ
  62.         Animatic Film                           *.FLM
  63.         Animaster Sprite Bank                   *.ASB
  64.         STOS                                    *.MBK
  65.         GEM Bit Image                           *.IMG
  66.         STAD                                    *.PAC
  67.         Imagic Film/Picture                     *.IC?   ? = 1, 2, 3
  68.         IFF                                     *.IFF
  69.         RGB Intermediate Format                 *.RGB
  70.         ComputerEyes Raw Data Format            *.CE?   ? = 1, 2
  71.         MacPaint                                *.MAC
  72.         PackBits Compression Algorithm
  73.  
  74.  
  75.                         Introductory Information
  76.                         ------------------------
  77. word    = 2 bytes
  78. long    = 4 bytes
  79. palette = Hardware color palette, stored as 16 words.  First word is
  80.           color register zero (background), last word is color register
  81.           15.  Each word has the form:
  82.  
  83.           Bit:  (MSB) 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 (LSB)
  84.                       -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  85.                        0  0  0  0  0 R2 R1 R0  0 G2 G1 G0  0 B2 B1 B0
  86.  
  87.           R2 = MSB of red intensity
  88.           R0 = LSB of red intensity
  89.  
  90.           G2 = MSB of green intensity
  91.           G0 = LSB of green intensity
  92.  
  93.           B2 = MSB of blue intensity
  94.           B0 = LSB of blue intensity
  95.  
  96.           Intensity ranges from 0 (color not present) to 7 (highest
  97.           intensity).
  98.  
  99.           Example: { red = 7, green = 3, blue = 5 } -> 0735 (hex)
  100.  
  101.           Caveat:  It is wise to mask off the upper four bits of each
  102.                    palette entry, since a few programs store special
  103.                    information there (most notably Art Studio).
  104.  
  105.  
  106.                              The Formats
  107.                              -----------
  108.  
  109. <NEOchrome>     *.NEO
  110.  
  111. 1 word          flag byte [always 0]
  112. 1 word          resolution [0 = low res, 1 = medium res, 2 = high res]
  113. 16 words        palette
  114. 12 bytes        filename [usually "        .   "]
  115. 1 word          color animation limits.  High bit (bit 15) set if color
  116.                 animation data is valid.  Low byte contains color animation
  117.                 limits (4 most significant bits are left/lower limit,
  118.                 4 least significant bits are right/upper limit).
  119. 1 word          color animation speed and direction.  High bit (bit 15) set
  120.                 if animation is on.  Low order byte is # vblanks per step.
  121.                 If negative, scroll is left (decreasing).  Number of vblanks
  122.                 between cycles is |x| - 1
  123. 1 word          # of color steps (as defined in previous word) to display
  124.                 picture before going to the next.  (For use in slide shows)
  125. 1 word          image X offset [unused, always 0]
  126. 1 word          image Y offset [unused, always 0]
  127. 1 word          image width [unused, always 320]
  128. 1 word          image height [unused, always 200]
  129. 33 words        reserved for future expansion
  130. 16000 words     picture data (screen memory)
  131. -----------
  132. 32128 bytes     total
  133.  
  134.  
  135. <NEOchrome Animation>        *.ANI
  136.  
  137. NOTE:      To get this feature on versions 0.9 and later select the Grabber
  138.         icon and click both mouse buttons in the eye of the second R in the
  139.         word GRABBER.
  140.            Interestingly enough, some versions of NEO only require you
  141.         to press the right button, not both.  Hmmm...
  142.  
  143. 1 long          magic number BABEEBEA (hex) (seems to be ignored)
  144. 1 word          width of image in bytes (always divisible by 8)
  145. 1 word          height of image in scan lines
  146. 1 word          size of image in bytes + 10 (!)
  147. 1 word          x coordinate of image (must be divisible by 16) - 1
  148. 1 word          y coordinate of image - 1
  149. 1 word          number of frames
  150. 1 word          animation speed (# vblanks to delay between frames)
  151. 1 long          reserved; should be zero
  152. --------
  153. 22 bytes        total for header
  154.  
  155. ? words         image data (words of screen memory) for each frame, in 
  156.                 order
  157.  
  158.  
  159. <DEGAS>         *.PI1 (low resolution)
  160.                 *.PI2 (medium resolution)
  161.                 *.PI3 (high resolution)
  162.  
  163. 1 word          resolution (0 = low res, 1 = medium res, 2 = high res)
  164.                 Other bits may be used in the future; use a simple bit
  165.                 test rather than checking for specific word values.
  166. 16 words        palette
  167. 16000 words     picture data (screen memory)
  168. -----------
  169. 32034 bytes     total
  170.  
  171.  
  172. <DEGAS Elite>   *.PI1 (low resolution)
  173.                 *.PI2 (medium resolution)
  174.                 *.PI3 (high resolution)
  175.  
  176. 1 word          resolution (0 = low res, 1 = medium res, 2 = high res)
  177.                 Other bits may be used in the future; use a simple bit
  178.                 test rather than checking for specific word values.
  179. 16 words        palette
  180. 16000 words     picture data (screen memory)
  181. 4 words         left color animtion limit table (starting color numbers)
  182. 4 words         right color animation limit table (ending color numbers)
  183. 4 words         animation channel direction flag (0 = left, 1 = off, 2 = right)
  184. 4 words         128 - animation channel delay in 1/60's of a second. [0 - 128]
  185.                 (I.e., subtract word from 128 to get 1/60th's of a second.)
  186. -----------
  187. 32066 bytes     total
  188.  
  189.  
  190. <DEGAS Elite (Compressed)>      *.PC1 (low resolution)
  191.                                 *.PC2 (medium resolution)
  192.                                 *.PC3 (high resolution)
  193.  
  194. 1 word          resolution (same as Degas, but high order bit is set;
  195.                 i.e., hex 8000 = low res, hex 8001 = medium res,
  196.                 hex 8002 = high res).  Other bits may be used in th